Release 10.1A: OpenEdge Development:
Progress Dynamics Managers API Reference

getPropertyList

This function retrieves properties from either the local temp-table or the Repository through the server-side Session Manager.

The function returns a CHR(3)-delimited list of corresponding property values.

Location: af\app\afsesmngrp.i

Parameters:

INPUT pcPropertyList AS CHARACTER

A comma-delimited list of properties for which to retrieve values.

INPUT plSessionOnly AS LOGICAL

Indicates how to retrieve the properties. If YES, retrieve the value from the client session If NO, retrieve the value from the client session if available, otherwise retrieve from the server. If unknown (?), retrieve from the server only.

Returns: CHARACTER

Notes:

The returned list of properties always has as many entries as pcPropertyList. If a property in pcPropertyList does not have a value, the procedure returns a blank value for that property.
If plSessionOnly is set to YES, the Repository is never checked. Unless the property value is set in the cache, a blank is returned even if a server value exists for the property.
If plSessionOnly is set to NO, the cache value is returned, if possible. If no cache value exists, the server value is retrieved and returned. If no value exists in the server, a blank is returned as the value of the property.
If plSessionOnly is set to ? (Unknown value), the cache is never checked and the value is read from the server. If no server value has been set, a blank is returned as the value of the property, even if there is a client cache value.
Examples: See the askQuestion procedure in af\app\afsesmngrp.i.